home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / concat19.zip / CONCAT.DOC next >
Text File  |  1991-10-26  |  8KB  |  203 lines
  1.                            WEB Computer Consulting
  2.  
  3.                                  CONCAT.EXE
  4.      ----------------------------------------------------------------------
  5.      Program Description:
  6.  
  7.           Concat is a file concatenation program used to join multiple 
  8.      files into a single combined file in a user specified sequence. 
  9.      Files can be concatenated one at a time or sorted by filespec 
  10.      as a group.  Sorting can be specified as any of the following and
  11.      can be combined for multi level sorts.  Concat will handle large files
  12.      and runs properly on Novell networks.
  13.  
  14.                    N - File name 
  15.                    E - File Extension
  16.                    D - DOS File Date
  17.                    T - DOS File Time
  18.                    S - File Size
  19.  
  20.      A detailed report and audit trail can be created by specifying the 
  21.      report option.  The report will detail all files and byte sizes as 
  22.      they are appended to the destination file.
  23.  
  24.      Concat will also handle TEXT files which will allow for the handling 
  25.      of CR/LF sequence.  This will allow concatenation of text editor files 
  26.      properly.  When processing in TEXT mode any embedded ^Z characters will
  27.      be stripped out of the data.  If a file contains only CR then specifying TEXT will convert
  28.      all CR to CR/LF.
  29.  
  30.      ------------------------------------------------------------------------
  31.      Command Line Options:
  32.  
  33.      1.    Destination Filename: (target)
  34.            This is the file that will be appended to (TARGET), or created 
  35.            if it already exists.  A complete path can be entered if file is
  36.            to be created on a drive or directory different from the current
  37.            directory.
  38.  
  39.      2.    Files to Add or Append:
  40.            This filespec represents all of the files to add or concatenate 
  41.            to the destination file.  Wildcards are allowed to specify groups
  42.            of files.  Enter Drive and Path if files are not in current working 
  43.         directory.
  44.  
  45.      3.    Sort order / Report file:
  46.            This parameter specifies the sort order to use if a group of files      
  47.            was entered in parameter 2.  The sorting is specified by the
  48.            letters NDTSE.  Sort order is determined by the order of NDTSE.
  49.            See Examples.
  50.  
  51.            If a / is entered following the sort order then a report will be        
  52.            created using the default name of concat.rep.  If a filename is 
  53.            entered following the / then a report is created using the entered
  54.            filename.
  55.  
  56.      4.    TEXT Processing Switch:
  57.            If a T is entered for this parameter then all CR in the files to
  58.            add will be converted to CR/LF sequences as files are processed.
  59.            Any embedded ^Z characters will be stripped out of the data.
  60.  
  61.      -----------------------------------------------------------------------
  62.  
  63.                            WEB Computer Consulting
  64.  
  65.                                  CONCAT.EXE
  66.      ----------------------------------------------------------------------
  67.  
  68.      Examples:
  69.  
  70.      1.    Concatenate 3 small binary files into 1 large file appending 
  71.            them in date/time order.
  72.  
  73.            Files to Concatenate:
  74.  
  75.                    SMALL1.BIN  7650  8-16-91  2:10
  76.                    SMALL2.BIN  3278  7-01-90  5:15
  77.                    PARTXC.BIN 10567  8-16-91  1:01
  78.  
  79.            Concat Command Line:
  80.  
  81.            CONCAT large.bin *.bin DT   (No Report)
  82.  
  83.            CONCAT c:\path\large.bin c:\old\*.bin DT   (No Report)
  84.  
  85.            CONCAT large.bin *.bin DT/ 
  86.                         (Report using default filename concat.rep)
  87.  
  88.            CONCAT large.bin *.bin DT/run.rep (Report using run.rep)
  89.  
  90.            Result:
  91.               The files will be concatenated as follows;
  92.               SMALL2.BIN + PARTXC.BIN + SMALL1.BIN
  93.  
  94.      -------------------------------------------------------------------------
  95.  
  96.      2.    Concatenate 4 small binary files into 1 large file appending them 
  97.            in filename, then extension, and then date/time order.
  98.  
  99.            Files to Concatenate:
  100.  
  101.                    SMALL1.BIN  7650  8-16-91  2:10
  102.                    SMALL1.AAA  7650  8-16-91  2:10
  103.                    SMALL2.BIN  3278  7-01-90  5:15
  104.                    PARTXC.BIN 10567  8-16-91  1:01
  105.  
  106.            Concat Command Line:
  107.  
  108.            CONCAT large.bin *.bin NEDT   (No Report)
  109.  
  110.            CONCAT large.bin *.bin NEDT/  
  111.                        (Report using default filename concat.rep)
  112.  
  113.            CONCAT large.bin *.bin NEDT/run.rep (Report using run.rep)
  114.  
  115.           Result:
  116.               The files will be concatenated as follows;
  117.               PARTXC.BIN + SMALL1.AAA + SMALL1.BIN + SMALL2.BIN
  118.  
  119.       ======================================================================
  120.       
  121.                            WEB Computer Consulting
  122.  
  123.                                  CONCAT.EXE
  124.  
  125.  
  126.  
  127. =============================================================================
  128.                           DISCLAIMER - AGREEMENT
  129. =============================================================================
  130.  
  131.      Users of CONCAT.EXE must accept this disclaimer of warranty:
  132.      "CONCAT.EXE is supplied as is.  The author WEB Computer Consulting 
  133.      disclaims all warranties, expressed or implied, including, without 
  134.      limitation, the warranties of merchantability and of fitness for any 
  135.      purpose. The author WEB Computer Consulting assumes no liability for 
  136.      damages, direct or consequential, which may result from the use of 
  137.      CONCAT.EXE."
  138.  
  139. =============================================================================
  140.  
  141.  
  142.  
  143.  
  144.      CONCAT.EXE is a "shareware program" and is provided at no charge
  145.      to the user for evaluation.  Feel free to share it with your
  146.      friends, but please do not give it away altered or as part of
  147.      another system.  The essence of "user-supported" software is to
  148.      provide personal computer users with quality software without
  149.      high prices, and yet to provide incentive for programmers to
  150.      continue to develop new products.  If you find this program
  151.      useful and find that you are using CONCAT.EXE and continue to use
  152.      CONCAT.EXE after a reasonable trial period, you must make a reg-
  153.      istration payment of $12.00 to WEB Computer Consulting.  The $12.00
  154.      registration fee will license one copy for use on any one
  155.      computer at any one time.  You must treat this software just like
  156.      a book.  An example is that this software may be used by any
  157.      number of people and may be freely moved from one computer
  158.      location to another, so long as there is no possibility of it
  159.      being used at one location while it's being used at another.
  160.      Just as a book cannot be read by two different persons at the
  161.      same time.
  162.  
  163.                            WEB Computer Consulting
  164.  
  165.                                  CONCAT.EXE
  166.      ----------------------------------------------------------------------
  167.  
  168.      Site-License arrangements may be made by contacting WEB Computer
  169.      Consulting.
  170.  
  171.      Anyone distributing CONCAT.EXE for any kind of remuneration must
  172.      first contact WEB Computer Consulting at the address below for 
  173.      authorization.
  174.  
  175.      You are encouraged to pass a copy of CONCAT.EXE along to your
  176.      friends for evaluation.  Please encourage them to register their
  177.      copy if they find that they can use it.  
  178.  
  179.      Future enhancements planned for CONCAT.EXE include the following:
  180.           - Menu driven user interface
  181.           - The ability to select files from multiple directories
  182.           - The ability to concatenate sections of files from byte counts
  183.  
  184.      All registered users will receive a copy of the latest version of
  185.      CONCAT.EXE and documentation.
  186.  
  187.  
  188.  
  189.      October 25, 1991
  190.  
  191.      WEB Computer Consulting
  192.      Wayne E. Birch
  193.      406 Leon Circle
  194.      Langhorne, Penna.  19053
  195.  
  196.      Compuserve: 73260,3020
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.